home *** CD-ROM | disk | FTP | other *** search
/ TeX 1995 July / TeX CD-ROM July 1995 (Disc 1)(Walnut Creek)(1995).ISO / macros / latex209 / contrib / misc / apalike.tex < prev    next >
Text File  |  1992-03-09  |  5KB  |  104 lines
  1. %% @texfile{
  2. %%   author = "Oren Patashnik",
  3. %%   version = "0.99b",
  4. %%   date = "29 Feb 1992",
  5. %%   filename = "apalike.tex",
  6. %%   address = "Please use electronic mail",
  7. %%   checksum = "103     854    5370",
  8. %%   email = "opbibtex@cs.stanford.edu",
  9. %%   codetable = "ISO/ASCII",
  10. %%   supported = "yes",
  11. %%   docstring = "Defines macros that make apalike work with plain TeX",
  12. %% }
  13. % apalike.tex, version 0.99b, for btxmac 0.99i, BibTeX 0.99c, TeX 3.0 or later.
  14. % Copyright (C) 1990--92; all rights reserved.
  15. % You may copy this file provided: that it's accompanied by btxmac.tex;
  16. % and that either you make absolutely no changes to your copy, or if you
  17. % do make changes, (1) you name the file something other than
  18. % `apalike.tex' and you remove all occurrences of `apalike.tex' from the
  19. % file, (2) you put, somewhere in the first twenty lines of the file,
  20. % your name, along with an electronic address at which others who might
  21. % use the file may reach you, and (3) you remove each occurrence of
  22. % Oren's name and electronic address from this file.  These restrictions
  23. % help ensure that all standard versions of these macros are identical,
  24. % and that Oren doesn't get deluged with inappropriate e-mail.
  25. %
  26. % This file, apalike.tex, contains TeX macros that let you use the
  27. % apalike bibliography style with plain TeX.  In essence, this file
  28. % provides the TeX counterpart to apalike.sty, the LaTeX style file
  29. % required for using the apalike bibliography style.  Please report any
  30. % bugs (outright goofs, misfeatures, or unclear documentation) to Oren
  31. % Patashnik (opbibtex@cs.stanford.edu).  These macros will become frozen
  32. % shortly after BibTeX version 1.00 is released.
  33. %
  34. % AMS-TEX WARNING: This style (apalike) doesn't work with AmS-TeX's
  35. % `amsppt' style, because AmS-TeX redefines the tie character `~' of
  36. % plain TeX, and the `amsppt' style redefines plain TeX's `\nobreak'
  37. % macro, so that a multiple-author reference for which `apalike'
  38. % automatically produces an in-text citation like `(Jones et~al., 1992)'
  39. % will throw AmS-TeX's `amsppt' style into an infinite loop, exceeding
  40. % its input stack size.  (I've checked no other AmS-TeX styles for this
  41. % problem.)  The AmS-TeX warning of btxmac.tex gives more information.
  42. % END OF AMS-TEX WARNING.
  43. %
  44. % Editorial note (i.e., flame):
  45. % Many journals require a style like `apalike', but I recommend that you
  46. % not use it if you have a choice---use something like `plain' instead.
  47. % Mary-Claire van Leunen (A Handbook for Scholars, Knopf, 1979) argues
  48. % convincingly that a style like `plain' encourages better writing than
  49. % one like `apalike'.  Furthermore the best argument for using an
  50. % author-date style like `apalike'---that it's "the most practical"
  51. % (The Chicago Manual of Style, University of Chicago Press, thirteenth
  52. % edition, 1982, pages 400--401)---falls flat on its face with the new
  53. % computer-typesetting technology.  For instance page 401 of the Chicago
  54. % Manual anachronistically states "The chief disadvantage of [a style
  55. % like `plain'] is that additions or deletions cannot be made after the
  56. % manuscript is typed without changing numbers in both text references
  57. % and list."  With (La)TeX the disadvantage obviously evaporates.
  58. % Moreover, apalike indulges in what I think is a shortsighted practice:
  59. % automatically abbreviating first names.  Abbreviating may occasionally
  60. % make the work a page shorter, but at the cost of a less useful
  61. % reference list; that's too high a cost for such a marginal benefit.
  62. % The offense isn't egregious for a name like `Donald E. Knuth'---at
  63. % least among those familiar with his field---since there aren't many
  64. % other `D. E. Knuth's floating around.  But referring to `D. E. Smith'
  65. % in a field having more than one can be quite confusing.  Moreover,
  66. % with the proliferation of computers and citation indexes nowadays,
  67. % it's important to indicate in the reference list an author's name
  68. % exactly as it appears in the work cited.  Automatically abbreviating
  69. % first names is simply bad scholarship.  (End of flame.)
  70. %
  71. % To use these macros you need the btxmac.tex macros, which let you use
  72. % BibTeX with plain TeX (rather than with LaTeX); the file btxmac.tex
  73. % explains those macros in detail, and gives examples.  You simply
  74. % \input apalike right after you \input btxmac to invoke these macros.
  75. %
  76. %
  77. %   HISTORY
  78. %
  79. % Oren Patashnik wrote the original version of these macros in December
  80. % 1990, for use with btxmac.tex.
  81. %
  82. %   12-Dec-90  Version 0.99a, first general release.
  83. %   29-Feb-92  0.99b, changed `\biblabelextrahang' to `\biblabelextraspace',
  84. %                     to keep up with btxmac.tex version 0.99i.
  85. %
  86. %
  87. % Here, finally (I swear, I thought he was never gonna stop), are the
  88. % macros.  The first bunch makes the label empty and sets 2em of
  89. % hanging indentation (via \biblabelextraspace) for each entry.
  90. %
  91. \def\biblabelprint#1{\noindent}%
  92. \def\biblabelcontents#1{}%
  93. \def\bblhook{\biblabelextraspace = 2em }%
  94. %
  95. %
  96. % And the last bunch formats an in-text citation: parens around the
  97. % entire citation; semicolons separating individual references; and a
  98. % comma between a reference and its note (like `page 41') if it exists.
  99. %
  100. \def\printcitestart{(}%         left paren
  101. \def\printcitefinish{)}%        right parent
  102. \def\printbetweencitations{; }% semicolon, space
  103. \def\printcitenote#1{, #1}%     comma, space, note (if it exists)
  104.